<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<HEAD>
     <TITLE>Legend</TITLE>
     <link rel="stylesheet" type="text/css" href="../../../ss/2.css" id="thecss">
     <script type="text/javascript" src="../../../scripts/csschange.js"></script>
</HEAD>

<BODY onload="readSS()">

<br>
<center>
<table border=3 cellpadding=5 cellspacing=0>
<tr>
     <td><h1 class="pagetitle">Legend</h1>
         <b><a href="../../../misc/suppkey.htm">Support Key:</a></b> 
         [<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<b><i class="fs">4</i></b>] 
         [<b class="s">X1</b>|<b class="s">X1.1</b>]
         [<b><i class="fs">IE4B2</i></b>|<span class="ns">M</span>|<b class="s">N6B1</b>|<b class="s">O7</b>]</td>
     <td><a href="#what">What is it?</a><br>
         <a href="#attrib">Attributes</a><br>
         <a href="#example">Tag Example</a>
     </td>
     <td><a href="#model">Parent/Content Model</a><br>
         <a href="#tips">Tips &amp; Tricks</a><br>
         <a href="#peculiar">Browser Peculiarities</a></td>
</tr>
<tr><td align=center colspan=3>
<font size=2>= <span class="sitetitle">Index DOT Html</span> by <a href="../../../misc/email.htm">Brian Wilson</a> =</font>
</td></tr>
</table>

<font size=2>
     <a href="../../index.html">Main Index</a> |
     <a href="../../tree/htmltree.htm">Element Tree</a> |
     <a href="../../tagindex/a.htm">Element Index</a> |
     <a href="../../supportkey/a.htm">HTML Support History</a></font>
</center>
<hr align="center" width="25%">

<br><br>
<table border=1 cellspacing=0 cellpadding=5>
<tr><td>
<table border=0 cellspacing=0>
<tr>
   <th colspan=3 valign=bottom class="field"><big><u><b
       class="colheaders">&#160;&#160;&#160;Quick Statistics&#160;&#160;&#160;</b></u></big><br></th>
</tr>
<tr><th align=left><b class="l3heading"><a href="../stats.htm#et">End Tag:</a></b><br></th>
    <td rowspan=7>&nbsp;&nbsp;</td>
    <td><span class="magicword">Required</span></td></tr>
<tr><th align=left valign=top><b class="l3heading"><a href="../stats.htm#std">Standards Details:</a></b><br></th>
    <td>HTML: In all 4.x DTDs<br>XHTML: In all 1.0 and 1.1 DTDs</td></tr>
<tr><th align=left><b class="l3heading"><a href="../stats.htm#xhtm">XHTML Modules:</a></b><br></th>
    <td><b class=alert>Forms</b></td></tr>
<tr><th align=left valign=top><b class="l3heading"><a href="../stats.htm#disp">CSS 'display' Type:</a></b><br></th>
    <td>"<b class="alert">inline</b>"</td></tr>
<tr><th align=left valign=top><b class="l3heading"><a href="../stats.htm#css">CSS Mapping:</a></b><br></th>
    <td>NA</td></tr>
<tr><th valign=top align=left><b class="l3heading"><a href="../stats.htm#rnd">Default Rendering:</a></b><br></th>
    <td>A caption embedded in the FIELDSET bounding box. Horizontal alignment of the caption depends on the ALIGN attribute</td></tr>
<tr><th align=left><b class="l3heading"><a href="../stats.htm#w3docs">Official Docs:</a></b><br></th>
    <td><a href="http://www.w3.org/TR/html401/interact/forms.html#h-17.10">HTML 4.x</a>, 
        <a href="http://www.w3.org/TR/xhtml-modularization/abstract_modules.html#s_extformsmodule">XHTML 1.1</a></td></tr>
</table>
</td></tr>
</table>

<br>
<a name="what"></a>
<dl>
<dt><big><b class="mainheading">What is it?</b></big>
    <dd>The LEGEND element assigns a caption to a FIELDSET
        grouping of form elements. Using a LEGEND is most useful when
        pages are rendered using non-visual formats. The ALIGN attribute
        of this element will allow horizontal and vertical alignment of
        LEGEND content with respect to the FIELDSET in visual browsers.
        <br><br>

        <b class="alert">Note:</b> Use of the LEGEND element is
        optional within a FIELDSET, and if used, must immediately follow
        the opening FIELDSET tag. If the LEGEND element uses the ACCESSKEY
        attribute, the form control within the parent FIELDSET with the
        lowest tabbing order receives the focus.
</dl>


<a name="attrib"></a>
<dl>
<dt><br><big><b class="mainheading">Common Attributes</b></big>
<dt><b class="subheading">%<a href="../attributes/core.htm">Core</a>%</b>
    <dd>[<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<b><i class="fs">4</i></b>] 
        [<b class="s">X1</b>|<b class="s">X1.1</b>]
        [<b><i class="fs">IE4B2</i></b>|<span class="ns">M</span>|<b class="s">N6B1</b>|<b class="s">O4</b>]

<dt><b class="subheading">%<a href="../attributes/accessibility.htm">Accessibility</a>%</b>
    <dd>[<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<b><i class="fs">4</i></b>] 
        [<b class="s">X1</b>|<b class="s">X1.1</b>]
        [<b><i class="fs">IE4B2</i></b>|<span class="ns">M</span>|<b class="s">N6</b>|<b class="s">O5</b>]

<dt><b class="subheading">%<a href="../attributes/events.htm">Events</a>%</b>
    <dd>[<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<b><i class="fs">4</i></b>] 
        [<b class="s">X1</b>|<b class="s">X1.1</b>]
        [<b><i class="fs">IE4B2</i></b>|<span class="ns">M</span>|<b class="s">N6B1</b>|<b class="s">O4</b>]

<dt><b class="subheading">%<a href="../attributes/language.htm">Language</a>%</b>
    <dd>[<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<b><i class="fs">4</i></b>] 
        [<b class="s">X1</b>|<b class="s">X1.1</b>]
        [<b><i class="fs">IE4</i></b>|<span class="ns">M</span>|<span class="ns">N</span>|<span class="ns">O</span>]

<dt><b class="subheading">%<a href="../attributes/editing.htm">Editing</a>%</b>
    <dd>[<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<b><i class="fs">4</i></b>] 
        [<span class="ns">X1</span>|<span class="ns">X1.1</span>]
        [<b><i class="fs">IE5.5</i></b>|<span class="ns">M</span>|<span class="ns">N</span>|<span class="ns">O</span>]

<dt><br><big><b class="mainheading">Specific Attributes</b></big>
<dt><b class="subheading">Accesskey</b>
<dt>[<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<b><i class="fs">4</i></b>] 
    [<b class="s">X1</b>|<b class="s">X1.1</b>]
    [<b><i class="fs">IE4</i></b>|<span class="ns">M</span>|<span class="ns">N</span>|<span class="ns">O</span>]
    <dd><b class="l3heading"><a href="../stats.htm#std">Standards Details:</a></b> 
        In all HTML 4.x/XHTML DTDs
    <dd><b class="l3heading">Required?</b> No
    <dd><b class="l3heading">Description:</b><br>
        This is a method of giving access/focus to an active HTML element using
        a keyboard character. This is a common GUI paradigm also known
        as a &quot;keyboard shortcut&quot; or &quot;keyboard accelerator&quot;
        A single character is used as the value of this attribute. In addition,
        a platform-dependent key is usually used in combination with the
        ACCESSKEY character to access the functionality of the active field.
    <dd><b class="l3heading">Values:</b> <a href="../../../misc/glossary.htm#cdata">CDATA</a>.
        [A single, case-insensitive character from a browser's character set.]

<dt><b class="subheading">Align</b>
<dt>[<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<b><i class="fs">4</i></b>] 
    [<b class="s">X1</b>|<span class="ns">X1.1</span>]
    [<b><i class="fs">IE4B2</i></b>|<span class="ns">M</span>|<b class="s">N6B1</b>|<span class="ns">O</span>]
    <dd><b class="l3heading"><a href="../stats.htm#std">Standards Details:</a></b> 
        Deprecated in HTML 4.x/XHTML 1.0; Dropped from XHTML 1.1 (use CSS instead)
    <dd><b class="l3heading">Required?</b> No
    <dd><b class="l3heading">Description:</b><br>
        Specifies the text alignment relative to the FIELDSET. 
    <dd><b class="l3heading">Values:</b><br>
        <b class="alert">Top</b> | <b class="alert">Bottom</b> |
        <b class="alert">Left</b> | <b class="alert">Right</b> -
        Basic alignment values indicated in HTML 4.0<br>
        <b class="alert">Center</b> - Extra Internet Explorer 4.0 value
        for horizontal alignment of content at the top of the LEGEND
</dl>


<a name="example"></a>
<dl>
<dt><big><b class="mainheading">Example</b></big>
    <dd><div class="example">&lt;<b class="tagname">fieldset</b>&gt;<br>
        &lt;<b class="tagname">legend</b> <span class="tagattrib">accesskey</span>=&quot;G&quot;
        <span class="tagattrib">tabindex</span>=&quot;1&quot;&gt;Gender&lt;/<b class="tagname">legend</b>&gt;<br>
        &#160;&#160;&#160;&#160;&lt;<b class="tagname">label</b>
        <span class="tagattrib">accesskey</span>=&quot;M&quot;&gt;&lt;<b class="tagname">input</b>
        <span class="tagattrib">type</span>=&quot;radio&quot; <span class="tagattrib">name</span>=&quot;Gender&quot;
        <span class="tagattrib">value</span>=&quot;Male&quot; /&gt;Male&lt;/<b class="tagname">label</b>&gt;
        &lt;<b class="tagname">br</b> /&gt;
        <br>
        &#160;&#160;&#160;&#160;&lt;<b class="tagname">label</b>
        <span class="tagattrib">accesskey</span>=&quot;F&quot;&gt;&lt;<b class="tagname">input</b>
        <span class="tagattrib">type</span>=&quot;radio&quot; <span class="tagattrib">name</span>=&quot;Gender&quot;
        <span class="tagattrib">value</span>=&quot;Female&quot; /&gt;Female&lt;/<b class="tagname">label</b>&gt;<br>
        &lt;/<b class="tagname">fieldset</b>&gt;</div>
</dl>


<a name="model"></a>
<dl>
<dt><big><b class="mainheading">Parent Model</b></big>
    <dd>&lt;<a href="../f/fieldset.htm">fieldset</a>&gt;
<dt><big><b class="mainheading">Content Model</b></big>
    <dd><b class="alert">%<a href="../shorthands.htm#inlinecontent">In-line Content</a>%</b>
</dl>


<a name="tips"></a>
<big><b class="mainheading">Tips &amp; Tricks</b></big>
<ul>
    <li>Nothing to Report
</ul>

<a name="peculiar"></a>
<big><b class="mainheading">Browser Peculiarities</b></big>
<ul>
    <li>Internet Explorer does not allow the TOP and BOTTOM values of the ALIGN
        attribute for this element yet. Instead, the LEGEND is always rendered at the
        top edge of the FIELDSET, and the LEFT | CENTER | RIGHT alignment values
        control positioning along this edge.
    <li><a href="../../../testing/html/tags/l/legend-bp3.htm">[Test]</a>
        In Internet Explorer 4.0 if a LEGEND exists and is <em>NOT</em> the first
        element after the opening FIELDSET tag, rendering problems occur. Such a
        construct is illegal according to the spec anyway, so don't do it.
    <li><a href="../../../testing/html/tags/l/legend-bp2.htm">[Test]</a>
        Use of the ACCESSKEY attribute for this element in IE 4.0 puts focus on
        the first form field within the parent FIELDSET.
    <li><a href="../../../testing/html/tags/l/legend-bp1.htm">[Test]</a>
        In Netscape 6 Beta 1, a black bordered box was automatically placed
        around the LEGEND content (equivalent of using &lt;legend STYLE="border: 
        2px solid black"&gt;). In later versions, no border box is applied.
    <li>In Netscape 6, the ALIGN attribute horizontally aligns content
        relative to the fieldset content, not relative to the fieldset box itself 
        (IE5 and early Netscape 6 betas align relative to the fieldset box.)
</ul>

<br>
<a href="../../../misc/copyright.htm">Boring Copyright Stuff...</a>

</BODY>
</HTML>

